نمونه کد Android

در این پست از رایگان اس ام اس شما با نمونه کد اندرویدی ما آشنا می شوید، همینطور می توانید این نمونه کد را به راحتی از انتهای همین پست دانلود کنید... ما در رایگان اس ام اس یک وب سرویس کامل برای ارسال و دریافت پیامک و احراز هویت و مدیریت کامل آن برای شما فراهم کرده ایم که براحتی میتوانید از آن استفاده کنید....

همواره با افتخارهمراه شما برنامه نویسان گرانقدر خواهیم بود...

معرفی نمونه کد اندروید برای اس ام اس

 

در ابتدا کتابخانه را به پروژه خود اضافه کنید. برای اضافه کردن کتابخانه به برنامه اندرویدیتان ابتدا فایل را در پوشه libs در زیر شاخه app قرار دهید. سپس کدهای زیر را به فایل build.gradle در شاخه app اضافه کنید.

implementation 'com.google.code.gson:gson:2.8.5'
implementation files('libs/raygansms.aar')

برنامه شما برای دریافت اطلاعات مورد نیاز باید دسترسی به اینترنت هم داشته باشد. برای این منظور خط زیر را در فایل AndroidManifest.xml اضافه کنید.

<uses-permission android:name="android.permission.INTERNET" /> 

اگر ProGuard را در برنامه تان فعال کرده‌اید کدهای زیر را هم به فایل آن اضافه کنید.

-keep public enum ir.trez.raygansms.**{
    *;
}
-keep public class ir.trez.raygansms.**{
    *;
}

حالا می‌توانید در برنامه اندرویدیتان از آن استفاده کنید.

برای استفاده از کتابخانه ابتدا یک نمونه از کلاس Raygansms ایجاد می کنید. دقت کنید اطلاعات ورودی مورد نیاز برای سازنده این نمونه نام کاربری و رمز سامانه پیامکی خودتان است. در ادامه هر یک از متدهای آنرا شرح می دهیم.

احراز هویت (متد getAuthHeader)

این متد رشته مورد نیاز برای احراز هویت (فیلد Authorization) را ایجاد می کند. این متد مقدار رشته ای بر می گرداند.

مقدار برگشتی متدها (شی Result)

متدهای دیگر کتابخانه (به غیر از getAuthHeader ) از این نوع بر می گردانند. این نوع شامل سه متغییر است. یکی Code از نوع ResultCode و بیانگر موفقیت آمیز بودن عملیات یا شماره خطا است. نوع Message متن نتیجه را مشخص می کند. نوع Result نتیجه مربوط به متد را مشخص می‌کند و می‌تواند عدد، رشته و از نوع JSON باشد.

در کد زیر نمونه کدی برای دریافت اعتبار حساب استفاده شده است. دقت کنید برای اجرا شما باید از کلاس Raygansms یک متغیر ایجاد کرده و متد مربوط به اجرا را در کد فرابخوانید.

private Raygansms raygansms = new Raygansms("username", "password");
private String[] Mobiles = { "09120000000", "09120000001" };
private RecipientsMessage[] recipientsMessages = {};
private String[] MessageIDs = { "1", "2" };
private String PhoneNumber = "5000000000";
private String UserGroupID = "1";
private Integer PORT = 90;
private String Hello = "سلام";
public class CallSMS extends AsyncTask<Void, Void, Result> {
    @Override
    protected void onPreExecute() { }
    @Override
    protected Result doInBackground(Void... voids) {
        try {
            return raygansms.GetCredit();
        } catch (IOException e) {
            e.printStackTrace();
        }
        return null;
    }
    @Override
    protected void onPostExecute(Result result) {
        updateUiWithResult(result);
    }
}

در اینجاد در متد updateUiWithResult نتیجه مورد نیاز را بررسی کرده و بر اساس خروجی نتیجه مورد نیاز را به کاربر نمایش دهید. برای نمونه کد زیر را مشاهده کنید.

private void updateUiWithResult(Result result) {
   if(result != null && textView != null && !this.isFinishing()) {
       String text = "Code:\t" + result.getCode() + "\nMessage:\t" + result.getMessage();
       if(result.getResult() != null){
           text += "\nResult:\t" + result.getResult();
       }
       textView.setText(text);
   }
}

در ادامه متدهای کتابخانه را شرح می دهیم.

ارسال پیام

ارسال پیام گروهی (متد SendMessage)

از این متد برای ارسال پیام گروهی استفاده می شود. بدیهی است از این پیام برای ارسال پیام تکی نیز میتوان استفاده نمود.

نمونه کد فراخوانی:

raygansms.SendMessage(PhoneNumber, Hello, Mobiles, UserGroupID, System.currentTimeMillis() / 1000L);

**ملاحضات:**

در صورتی که تاریخ ارسال، از تاریخ فعلی کمتر باشد یا به عبارتی دیگر از زمان مورد نظر عبور کرده باشید، پیام مورد نظر در لحظه ارسال خواهد شد.

ارسال پیام متناظر (متد SendCorrespondingMessage)

از این متد برای ارسال پیام متناظر استفاده می شود.

نمونه کد فراخوانی:

raygansms.SendCorrespondingMessage(PhoneNumber, recipientsMessages, UserGroupID);

ارسال پیام به پورت خاص (متد SendMessageToPort)

از این متد برای ارسال پیام به پورت خاص استفاده می شود.

نمونه کد فراخوانی:

raygansms.SendMessageToPort(PhoneNumber, PORT, PORT, UserGroupID, recipientsMessages);

مشاهده وضعیت ارسال پیام گروهی (متد GroupMessageStatus)

از این متد برای واکشی، وضعیت لیست پیام های ارسالی استفاده می شود.

نمونه کد فراخوانی:

raygansms.GroupMessageStatus(UserGroupID);

مشاهده وضعیت ارسال پیام متناظر (متد CorrespondingMessageStatus)

از این متد برای واکشی ، وضعیت لیست پیام های ارسالی استفاده می شود.

نمونه کد فراخوانی:

raygansms.CorrespondingMessageStatus(MessageIDs);

دریافت شناسه گروه پیام (متد GetGroupMessageId)

از این متد برای دریافت ، شناسه گروه پیام ارسالی استفاده می شود.

نمونه کد فراخوانی:

raygansms.GetGroupMessageId(UserGroupID);

پیام های دریافتی (متد ReceiveMessages)

از این متد برای واکشی ، لیست پیام های در یافتی استفاده می شود.

نمونه کد فراخوانی:

raygansms.ReceiveMessages(PhoneNumber, (System.currentTimeMillis() - (60 \* 60 \* 24 \* 60)) / 1000L,System.currentTimeMillis() / 1000L, 1);

دریافت اعتبار (متد GetCredit)

از این متد برای واکشی ، اعتبار کاربر استفاده می شود.

نمونه کد فراخوانی:

raygansms.GetCredit();

قیمت پیامک (متد GetPrices)

از این متد برای واکشی تعرفه ارسال پیامک توسط کاربر استفاده می شود.

نمونه کد فراخوانی:

raygansms.GetPrices();

بررسی شماره ها در لیست سیاه (متد ShowWhiteList) = (پیامک سفید)

خروجی متد زیر لیست شماره موبایل هایی است که در لیست سیاه قرار ندارند.

نمونه کد فراخوانی:

raygansms.ShowWhiteList(Mobiles);

تفسیر کد های خروجی